From 5484211c906094fc1fc37b300b08a699c011432e Mon Sep 17 00:00:00 2001
From: =?utf8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Wed, 1 Sep 2010 19:49:44 +0200
Subject: [PATCH] gtktexttagtable: move documentation to inline comments

---
 docs/reference/gtk/tmpl/.gitignore           |   1 +
 docs/reference/gtk/tmpl/gtktexttagtable.sgml | 125 -------------------
 gtk/gtktexttagtable.c                        |  29 ++++-
 3 files changed, 29 insertions(+), 126 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtktexttagtable.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index c9a1746bfc..ad67ef7d9a 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -31,6 +31,7 @@ gtkstatusbar.sgml
 gtkstyle.sgml
 gtktesting.sgml
 gtktextiter.sgml
+gtktexttagtable.sgml
 gtktoggleaction.sgml
 gtktoolitem.sgml
 gtktreednd.sgml
diff --git a/docs/reference/gtk/tmpl/gtktexttagtable.sgml b/docs/reference/gtk/tmpl/gtktexttagtable.sgml
deleted file mode 100644
index 748682f2d5..0000000000
--- a/docs/reference/gtk/tmpl/gtktexttagtable.sgml
+++ /dev/null
@@ -1,125 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkTextTagTable
-
-<!-- ##### SECTION Short_Description ##### -->
-
-Collection of tags that can be used together
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-You may wish to begin by reading the <link linkend="TextWidget">text widget
-conceptual overview</link> which gives an overview of all the objects and data
-types related to the text widget and how they work together.
-</para>
-
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkTextTagTable ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL GtkTextTagTable::tag-added ##### -->
-<para>
-
-</para>
-
-@texttagtable: the object which received the signal.
-@arg1: 
-
-<!-- ##### SIGNAL GtkTextTagTable::tag-changed ##### -->
-<para>
-
-</para>
-
-@texttagtable: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkTextTagTable::tag-removed ##### -->
-<para>
-
-</para>
-
-@texttagtable: the object which received the signal.
-@arg1: 
-
-<!-- ##### USER_FUNCTION GtkTextTagTableForeach ##### -->
-<para>
-
-</para>
-
-@tag: 
-@data: 
-
-
-<!-- ##### FUNCTION gtk_text_tag_table_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_text_tag_table_add ##### -->
-<para>
-
-</para>
-
-@table: 
-@tag: 
-
-
-<!-- ##### FUNCTION gtk_text_tag_table_remove ##### -->
-<para>
-
-</para>
-
-@table: 
-@tag: 
-
-
-<!-- ##### FUNCTION gtk_text_tag_table_lookup ##### -->
-<para>
-
-</para>
-
-@table: 
-@name: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_text_tag_table_foreach ##### -->
-<para>
-
-</para>
-
-@table: 
-@func: 
-@data: 
-
-
-<!-- ##### FUNCTION gtk_text_tag_table_get_size ##### -->
-<para>
-
-</para>
-
-@table: 
-@Returns: 
-
-
diff --git a/gtk/gtktexttagtable.c b/gtk/gtktexttagtable.c
index b8b7afd604..daaab7f59c 100644
--- a/gtk/gtktexttagtable.c
+++ b/gtk/gtktexttagtable.c
@@ -33,6 +33,17 @@
 #include <stdlib.h>
 
 
+/**
+ * SECTION:gtktexttagtable
+ * @Short_description: Collection of tags that can be used together
+ * @Title: GtkTextTagTable
+ *
+ * You may wish to begin by reading the <link linkend="TextWidget">text widget
+ * conceptual overview</link> which gives an overview of all the objects and data
+ * types related to the text widget and how they work together.
+ */
+
+
 struct _GtkTextTagTablePrivate
 {
   GHashTable *hash;
@@ -77,7 +88,13 @@ gtk_text_tag_table_class_init (GtkTextTagTableClass *klass)
   object_class->get_property = gtk_text_tag_table_get_property;
   
   object_class->finalize = gtk_text_tag_table_finalize;
-  
+
+  /**
+   * GtkTextTagTable::tag-changed:
+   * @texttagtable: the object which received the signal.
+   * @tag: the changed tag.
+   * @size_changed: whether the size has been changed.
+   */
   signals[TAG_CHANGED] =
     g_signal_new (I_("tag-changed"),
                   G_OBJECT_CLASS_TYPE (object_class),
@@ -90,6 +107,11 @@ gtk_text_tag_table_class_init (GtkTextTagTableClass *klass)
                   GTK_TYPE_TEXT_TAG,
                   G_TYPE_BOOLEAN);  
 
+  /**
+   * GtkTextTagTable::tag-added:
+   * @texttagtable: the object which received the signal.
+   * @tag: the added tag.
+   */
   signals[TAG_ADDED] =
     g_signal_new (I_("tag-added"),
                   G_OBJECT_CLASS_TYPE (object_class),
@@ -101,6 +123,11 @@ gtk_text_tag_table_class_init (GtkTextTagTableClass *klass)
                   1,
                   GTK_TYPE_TEXT_TAG);
 
+  /**
+   * GtkTextTagTable::tag-removed:
+   * @texttagtable: the object which received the signal.
+   * @tag: the removed tag.
+   */
   signals[TAG_REMOVED] =
     g_signal_new (I_("tag-removed"),  
                   G_OBJECT_CLASS_TYPE (object_class),
-- 
2.30.2